home *** CD-ROM | disk | FTP | other *** search
/ PD ROM 1 / PD ROM Volume I - Macintosh Software from BMUG (1988).iso / Graphics / Graphic Demos / Stair Draw / Stair Draw Documentation next >
Encoding:
Text File  |  1987-01-19  |  4.6 KB  |  102 lines  |  [TEXT/ttxt]
  1. Stair Draw
  2. Version 0.90  18-January-1987
  3. written by George Langdon
  4. assembled with Lightspeed Pascal
  5.  
  6. INTRODUCTION
  7.  
  8. Stair Draw draws a stair section based on the floor-to-floor height you
  9. enter and the layout selections you make.  It is a great assist to architects
  10. who have to deal with such mundane things as stairs over and over.
  11.  
  12. It was also an opportunity of me to develop an deep appreciation for the
  13. Macintosh ROM and the abilities of Lightspeed Pascal.  You are welcome
  14. to borrow from the code to set up windows (complete with scroll 
  15. bars), menus, and dialogs.  In return, you can suggest ways to improve
  16. Stair Draw functionally and the efficiency of its code.  Please leave 
  17. messages on either at MacFido net 125 / node 444 in San Francisco 
  18. (415/923-1235) or on BMUG in Berkeley (415//849-2684).
  19.  
  20. USAGE
  21.  
  22. Use Stair Draw to layout the vertical section for either a U-type or
  23. Straight run stair.  It adjusts the tread dimension for varing riser heights,
  24. and  calculates the important data (such as number risers, height, etc).
  25. Stair Draw will automatically add a landing in a straight-run stair that
  26. has a floor-to-floor height greater than 12'-0" (because that's what the 
  27. code requires).
  28.  
  29. You can save the stair section in the window by selecting Savefrom the 
  30. Edit menu.  Be certain your default disk is named Stair Disk; otherwise, 
  31. Stair Draw will not be able to find the correct volume.  The drawing is 
  32. saved in MacPaint file format.  You can open it with MacPaintor a DA such 
  33. as PaintGrabber.
  34.  
  35. You can change the scale of the stair section or the pen size from the 
  36. appropriate menus; however, you must do so after OKing of CANCELing
  37. the Stair Data dialog. Select New from the Edit menu to draw a new stair 
  38. section, using any new scale or pen size.
  39.  
  40. DA's should work while using Stair Draw.  Therefore, you can use the 
  41. calculator to determine heights or PaintGrabber to select and copy the
  42. stair section directly to the Clipboard.  I have not tried all DA's or 
  43. FKEY's so I can not vouch for total compatibility.  It is v0.90, afterall.
  44.  
  45. LIMITATIONS
  46.  
  47. Stair Draw is not complete.  It's main limitation is that it does not allow
  48. you to select a file name to Save as... or to save more than one stair 
  49. drawing at a time.  Coming real soooon now!  It would be a big help if 
  50. someone knows how to save a file in MacDraw format.  Any info or ideas?
  51.  
  52. The future suggests that Stair Draw will also be able to draw the stair in
  53. plan as well as in section, offer options as to the start point, do three
  54. run stairs, and all those other things that architects hate to have to layout
  55. themselves.  Of course, if it's that good, it ought to be worth something?
  56.  
  57. HINTS
  58.  
  59. Use Stair Draw to layout the stair section.  Clip a copy to the clipboard or
  60. save it to the Scrapbook with PaintGrabber or FKEY #9, and then paste the
  61. section into MacDraw.  Use MacDraw to duplicate the section and locate
  62. the copys end-to-end.  Add vertical dimensions for floor-to-floor height
  63. and number of risers at riser dimension shown.  Print the overall section
  64. on the ImageWriter or the LaserWriter.  And there, the job is done.
  65.  
  66. THE SCOURCE
  67.  
  68. Stair Draw is written in Pascal and assembled using Lightspeed Pascal
  69. from Think.  The scource is available if you wish to kibitz.  There is 
  70. the "Stair Project" and three units: "Stair_Globals", "Stair_Program", 
  71. and "Stair_Main".  Also included is "Stair Draw.rsrc" that contains the 
  72. resources necessary to the program.  You need Lightspeed Pascal to 
  73. modify the scource and ResEdit to modify the resources.
  74.  
  75. There is an "ICN#" resource in the .rsrc file.  If you reassemble the source
  76. you need to use the command "Get Info" in ResEdit to show the file creator
  77. as "SDRW".  Then the Desktop can locate the file's correct icon.
  78.  
  79. If you are experienced in programming the Macintosh, I would appreciate
  80. your suggestions on improving the code.  This is my first serious attempt,
  81. and I had many difficulties with such matters as updating regions, and
  82. the scroll bars bouncing back at their ends.  I have not yet developed
  83. procedures to save the drawing to a file, so I have depended on the LSP
  84. standard procedure "SaveDrawing".  This saves the window in MacPaint 
  85. format, similar to Command-Shift-3.  Any suggestions on saving the 
  86. picture directly to the clipboard or in MacDraw file format would be
  87. helpful.
  88.  
  89. FINAL COMMENTS
  90.  
  91. In closing I want to thank Leo Laporte who encouraged me to get into it...
  92. even if he did say use assembly.  Thanks also to Vernon Keenan (who's 
  93. MacFido Tribune keeps me so well informed), and to Raines Cohen and 
  94. the folks at BMUG.  
  95.  
  96. Let's all do it... write more Public Domain Software, that is.
  97.  
  98. George Langdon
  99. Oakland, Ca
  100. January 18, 1987
  101.  
  102.